home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / mac / raytrace / dkb / mcprt102.bnh / DKBTrace-Mac.doc
Encoding:
Text File  |  1991-08-10  |  4.6 KB  |  112 lines
  1. #### Using DKBTrace 2.12 - Macintosh version 1.0.2 ####
  2.  
  3. The DKBTrace application provided here requires a Macintosh with FPU and 32-Bit
  4. QuickDraw, running System 6.0.5 or newer. It will complain if your machine does
  5. not satisfy these requirements.
  6. To use it, select "Trace..." from the "File" menu. You will be presented with
  7. a dialog box specifying the tracing parameters. The options you can set here
  8. are the same as the command-line options detailed in the DKBTrace docs.
  9. The settings you enter in this dialog box will be remembered, even across
  10. multiple launches. Only the "Resume" option is always cleared, and the input
  11. file is not remembered across launches.
  12.  
  13. The library search paths must be entered in the usual Mac fashion, with colons
  14. separating directories in the pathname. Spaces are allowed, as are partial
  15. pathnames. Pathnames are separated by carriage returns. By the way, I have
  16. experienced problems when the INIT "Cmdr. Dialog II" is active: you won't be
  17. able to type a Return in the "Library Search Paths" field, because this will
  18. be interpreted as clicking OK (even if it is disabled!). I have not been able
  19. to solve this, unfortunately.
  20.  
  21. The output file is created in the same directory as the input file. It is
  22. automatically named: the suffix ".dat" or ".data" is stripped from the input
  23. file (if necessary), and the suffix ".dis" is added for Dump/QRT files, ".tga"
  24. for Targa files, and ".red", ".grn" and ".blu" for Raw files.
  25.  
  26. You can abort a trace using "Abort" from the "File" menu. An aborted trace can
  27. be resumed later, as described in the DKBTrace manual. Be sure to leave the
  28. output file in the same directory as the input file so DKBTrace can find it.
  29.  
  30. Final hint: if you experience out-of-memory problems when starting a second
  31. trace (or restarting one) within one session, try quitting and re-launching.
  32. This may also be necessary when resuming an aborted trace using Targa output
  33. format. These problems are caused by the fact that the DKBTrace code is called
  34. as a subroutine by the Mac front-end. It is not launched into a separate heap,
  35. so memory allocated but not explicitly freed will gradually fill the DKBTrace
  36. application's heap after multiple traces. Also, initialized globals are only
  37. initialized once, and not for every run. Apparently, the Targa-resume bug is
  38. caused by the latter problem.
  39.  
  40. #### Changes ####
  41.  
  42. 1.0 -> 1.0.1
  43. * Plot window now displays colours correctly.
  44. * Dithering in the Plot window is now optional.
  45. * Pause option added to setup dialog. When this option is on, the Plot window
  46.   is not closed immediately when the trace is finished, so you get a chance to
  47.   get a look at it.
  48.  
  49. 1.0.1->1.0.2
  50. * Output files now get appropriate types and creators.
  51.  
  52. #### Compiling DKBTrace 2.12 with MPW C 3.0 ####
  53.  
  54. Replace the files dkbproto.h, prioq.c, quartics.c, render.c and trace.c from
  55. the DKBTrace distribution with the files in the this archive. Add the files
  56. DKBTrace.make, mac_mpw.c, mac_mpwconf.h, mac_mpw.r and mac_mpw.rsrc to the same
  57. directory. Rename mac_mpwconf.h to config.h. Make the directory containing all
  58. sources current, and type "BuildProgram DKBTrace".
  59.  
  60. #### Added files: ####
  61.  
  62. DKBTrace.make
  63. mac_mpw.c
  64. mac_mpwconf.h
  65. mac_mpw.r
  66. mac_mpw.rsrc
  67.  
  68. #### Changed files: ####
  69.  
  70. dkbproto.h
  71. dump.c
  72. prioq.c
  73. quartics.c
  74. raw.c
  75. render.c
  76. targa.c
  77. trace.c
  78.  
  79. #### File changes: ####
  80.  
  81. --------- dkbproto.h ---------
  82. Renamed "entry" to "Entry" everywhere; it is a reserved symbol in MPW C.
  83. Renamed "power" to "Power" everywhere; it conflicts with the power() function
  84. in the SANE library.
  85.  
  86. --------- prioq.c ---------
  87. Renamed "entry" to "Entry" everywhere; it is a reserved symbol in MPW C.
  88.  
  89. --------- quartics.c ---------
  90. Renamed "power" to "Power" everywhere; it conflicts with the power() function
  91. in the SANE library.
  92. Split some expressions in Intersect_Quartic() Quartic_Normal() to avoid MPW C's
  93. "expression too complicated" complaints; also optimized those expressions
  94. somewhat by eliminating some common subexpressions.
  95.  
  96. --------- render.c ---------
  97. Made TEST_ABORT call conditionally compiled: it is now called from
  98. Start_Trace() on non-Mac systems (once per pixel) and from Trace() on Macs
  99. (once per ray).
  100. In Read_Rendered_Part() and Start_Tracing(): changed type cast for colour
  101. components (for display_plot() call) from (char) to (unsigned char). Casting
  102. to (char), MPW C gives values -128 to 127, while you want 0 to 255.
  103.  
  104. --------- trace.c ---------
  105. main() renamed to Main()
  106. Made code to read trace.def (lines 336-340) conditionally compiled (not
  107. needed).
  108.  
  109. --------- dump.c, raw.c, targa.c ---------
  110. Added code to set Mac file type & creator in Open_Dump_File(), Open_Raw_File()
  111. and Open_Targa_File().
  112.